QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Notice Method Selectors

The method parameter passed to the QAGetNoticeMethod and QASetNoticeMethod functions specifies a type of notice method. QuickDraw 3D RAVE defines these constants for method selectors.

typedef enum TQAMethodSelector {
    kQAMethod_RenderCompletion                      = 0,
    kQAMethod_DisplayModeChanged                    = 1
    kQAMethod_ReloadTextures                        = 2,
    kQAMethod_BufferInitialize                      = 3,
    kQAMethod_BufferComposite                       = 4,
    kQAMethod_NumSelectors                          = 5
} TQAMethodSelector;

Constant descriptions

kQAMethod_RenderCompletion
The renderer has finished rendering an image. If the draw context is double buffered, the completion method is called after the front and back buffers have been swapped.
kQAMethod_DisplayModeChanged
The display mode has changed. In response to this notification, you should verify that all your draw contexts are still visible on the screen.
kQAMethod_ReloadTextures
The texture memory has become invalid. In response to this notification, you should reload any textures you're using.
kQAMethod_BufferInitialize
A buffer needs to be initialized. This notification is sent before rendering starts. You are responsible for clearing the buffer to the desired image. Your buffer initialization method is given a reference to the device to clear, which is always a memory device. You can set a drawing engine's kQATag_BufferComposite state variable to indicate how you want the engine to composite generated pixels with the pixels in that image.
kQAMethod_BufferComposite
Rendering is finished and it is safe to composite. This notification is sent after rendering has finished but before the buffers are swapped. Your buffer compositing method is given a reference to the device to composite into, which is always a memory device.
kQAMethod_NumSelectors
The number of method selectors currently defined.

© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |